Carbon


RealFont

Header: Fonts.h Carbon status: Supported

Determines whether a font is available or is intended for use in a specified size.

Boolean RealFont (
    SInt16 fontNum, 
    SInt16 size
);
Parameter descriptions
fontNum

The font family ID.

size

The font size requested.

function result

TRUE if the requested size of a font is available. RealFont first checks for a bitmapped font from the specified family. If one is not available, RealFont checks next for an outline font. If neither kind of font is available, RealFont returns FALSE.

DISCUSSION

If an outline font exists for the requested font family, RealFont normally considers the font to be available in any requested size; however, the font designer can include instructions in the font that outlines should not be used at certain point sizes, in which case the RealFont function will consider the font unavailable and return FALSE. The Font Manager determines whether the size is valid by testing the value of the smallest readable size element of the font family header table, which is described with the 'FOND' resource.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)